home *** CD-ROM | disk | FTP | other *** search
/ Network Support Library / RoseWare - Network Support Library.iso / apidev / sc3x03.exe / CUSEFILE.DOC < prev    next >
Text File  |  1992-10-09  |  3KB  |  71 lines
  1.  
  2.  
  3.  
  4.  
  5.                    Get Connections Using A File
  6.  
  7.     This call returns all logical connections using the file specified
  8.     by the Volume Number and Directory Entry Number (Sequence Number).
  9.     If only a path is available for the file, the Directory Entry Number
  10.     can be obatined by calling the ConvertPathToDirectoryEntry function.
  11.  
  12.     Function 23 (17h)
  13.   
  14.     Request Buffer
  15.  
  16.         Offset   Request Packet Contents        Bytes    Remarks
  17.         ------   ---------------------------    -----    -------
  18.         0        Sub-function Structure Len     2        Length
  19.         2        236 (ECh)                      1
  20.         3        Data Stream Type               1
  21.         4        Volume Number                  1
  22.         5        Directory Entry Number         4
  23.         9        Last Record Seen               2 
  24.  
  25.     Reply Buffer
  26.  
  27.         Offset   Request Packet Contents        Bytes    Remarks
  28.         ------   ---------------------------    -----    -------
  29.         0        Next Request Record            2   
  30.         2        Use Count                      2
  31.         4        Open Count                     2
  32.         6        Open For Read Count            2
  33.         8        Open For Write Count           2
  34.         10       Deny Read Count                2
  35.         12       Deny Write Count               2
  36.         14       Locked                         1
  37.         15       Data Stream Type               1
  38.         16       Number Of Records              2        Max 70
  39.         18       Connection Number 1            2        .
  40.         20       Task Number 1                  2        .
  41.         22       Lock Type 1                    1        .
  42.         23       Access Flag 1                  1        Repeats Number 
  43.         24       Lock Flag 1                    1        Of Record Times
  44.         .        .                              .        .               
  45.         .        .                              .        .
  46.         .        Connection Number  n           2        Where n is one
  47.         .        Task Number  n                 2        of the connections
  48.         .        Lock Type  n                   1        using the file
  49.         .        Access Flag  n                 1        .
  50.         .        Lock Flag  n                   1        .
  51.         .        .                              .        .               
  52.                
  53.     The Data Stream Type determines the data space of the specified 
  54.     entry.  
  55.  
  56.     Volume Number is the number of the volume where the file resides.
  57.  
  58.     Directory Entry is the files entry or sequence number in the file
  59.     system.
  60.  
  61.     Last Record Seen is the last connnection number for which information
  62.     was returned.  This should be set to zero on the first iteration of
  63.     this call.   If more than 70 connections hold the file open, this
  64.     filed should be set to the value of nextRequestRecord from the Reply
  65.     Buffer.
  66.         
  67.     Reply Buffer values are as documented in the NetWare System Calls -
  68.     DOS, version 1.00.  The only exception is the Data Stream Type, which
  69.     is documented above.    
  70.  
  71.